home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / s_ver092.zip / S-VER.DOC < prev    next >
Text File  |  1990-11-24  |  14KB  |  420 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.     
  9.                                  S-VER
  10.  
  11.  
  12.                             COPYRIGHTED 1990
  13.  
  14.  
  15.                                   BY
  16.  
  17.  
  18.                             STEVE GABRILOWITZ
  19.  
  20.  
  21.  
  22.              A CALLBACK VERIFIER FOR QUICKBBS OR REMOTE ACCESS
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                             Table of Contents:
  29.  
  30.  
  31.                Item of Information                    Page #
  32.                ---------------------------------------------
  33.  
  34.  
  35.                Reason S-VER was written ................ 2
  36.                Beta Testing Cycle ...................... 2
  37.                Registration ............................ 2
  38.                Installation ............................ 3
  39.                Control of Phone Numbers .............. 3,4
  40.                Convert.exe Program ..................... 4
  41.                S-VERCFG.EXE ............................ 4
  42.                Support Files ........................... 4
  43.                  S-INTRO.A?? ........................... 5
  44.                  S-TRASH.A?? ........................... 5
  45.                  S-DUPE.A?? ............................ 5
  46.                  S-LOGIN.A?? ........................... 5
  47.                  S-VALID.A?? ........................... 5
  48.                  S-LONGD.A?? ........................... 6
  49.                  S-VERM.ASC ............................ 6
  50.                  S-VERM.MNU ............................ 6
  51.                Operation of S-VER ...................... 6
  52.                Warranty ................................ 6
  53.                Progess Report / Updates ................ 7
  54.                Special Mentions ........................ 7
  55.                CopyRights .............................. 7
  56.  
  57.  
  58.  
  59.  
  60. S-VER.DOC                                                      PAGE 1
  61.  
  62.  
  63.  
  64.  
  65.  
  66. REASONING FOR WRITING "S-VER"
  67. -----------------------------
  68.   'S-VER' is a  'callback verifier' written original for use with the
  69. Remote Access bulletin board system.   As far as I know,  this is the
  70. only program of its kind that is designed with a multi-node RA system
  71. in mind.   The reason I wrote it is because I couldn't get any of the
  72. other  callback systems  to work right on my  multi-node  system  and
  73. figured that there must be other Sysops having the same problem!   Of
  74. course,  it will also work on a single node Quickbbs or RA system and
  75. also has  features intended to make it as flexible and easy to set up
  76. as possible.
  77.  
  78.  
  79.  
  80.  
  81. BETA TEST CYCLE
  82. ---------------
  83.  
  84.   'S-VER' has currently been  tested on computer systems ranging from
  85. the slowest  XT to a  34 Mhz 386, and with  modems ranging from  2400
  86. baud internal to a 14.4 HST, and has performed well on all.
  87.  
  88.  
  89.  
  90.  
  91. REGISTRATION
  92. ------------
  93.  
  94.                        THIS IS NOT FREE SOFTWARE!
  95.  
  96.   If you like and use S-VER on your system, please show your apprecia-
  97. tion by registering.  Until you are registered and recieve your regis-
  98. tration key,  the  software will make a note in your log reminding you
  99. to register.  It will also inform your users that it is not registered
  100. and subject them to a 10 second  delay before  asking them which phone
  101. number to dial.   If you try it and it doesn't work for you, or if you
  102. decide you don't like it,  then please drop  me a note telling me why. 
  103. This will help me make improvements as needed in future versions.
  104.  
  105.   I have just heard of a  New Concept  in  software  marketing  called
  106. DinnerWare. If you like this program, you can treat me and my wife out
  107. to dinner.   We like to eat at  Burger King  and  Pizza Hut,  but also
  108. really enjoy Red Lobster and Olive garden <grin>  Seriously, send what
  109. you  feel  you  can  afford, or what you think the  program  is worth.
  110. Also,  if you have any  bug reports or  suggestions for  improvements,
  111. please send them  electronically  (1:363/1701)   1-407-380-1701 or via 
  112. US mail to:
  113.  
  114.                                     Steve Gabrilowitz
  115.                                     122 North DeerWood Avenue
  116.                                     Orlando, Florida 32825
  117.  
  118.  
  119.  
  120.  
  121. S-VER.DOC                                                      PAGE 2
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. INSTALLATION
  129. ------------
  130.  
  131.   First UnZip the 'S-VER.ZIP'  package...  Inside you will find a menu,
  132. support files, questionnaire, config & Exe. files.  All Text files will
  133. be placed in the Text files directory defined in your BBS configuration.
  134. The Menu  goes into the  Menus directory  defined  in your  BBS config-
  135. uration.  All other files are placed in The Main BBS directory.
  136.  
  137.   When install 'S-VER',   you must first run the configuration  program
  138. SVER-CFG.   It will create the Configuration file in the current direc-
  139. tory.  This may be either your main  BBS system directory as pointed to
  140. by the environment variable RA on a RA system, or one of the multi-node
  141. sub-directories.    On a  QuickBBS system,  it must be in your main BBS
  142. directory.   If in the main directory,  the configuration will apply to
  143. all nodes that don't have their own configuration.   This allows you to
  144. customize the setup as much as may be necessary.  
  145.  
  146.   'SVER-CFG' is pretty much self explanatory, but a few comments on the
  147. modem specific portion are in order.  First, try the default setup.  It
  148. has worked on  every system  I've tried it on so far,  so why mess with
  149. success? ;-)   If you need to modify the init string,   settings higher
  150. than X3 have been observed to cause problems when it tries to dial out.
  151. In the  current version  I think I have  fixed  this,   but if you have
  152. problems  that is the first place to look.   On some  1200 baud modems,
  153. you may need to use  X1  or  X2.   The modem must return verbose status
  154. codes for this program to work, numeric ones won't be recognized.    To
  155. toggle the settings between Yes and No, use the space bar.   Also,  the
  156. long distance Calling hours will not be displayed unless you have  long
  157. distance  Set to Yes  -  set them both to the same time (doesn't matter
  158. what time you put in) if you want to allow long distance calling 'round 
  159. the clock.
  160.  
  161.  
  162.  
  163.  
  164. CONTROL OF PHONE NUMBERS
  165. ------------------------
  166.   The  phone number  setup is done in a  manner similar to what you are
  167. probably familiar with in your nodelist processor.     The control file
  168. for this purpose is called  PHONE#.CTL  and may reside  either  in your
  169. main directory or a node directory.    Each line in the file looks like
  170. this:
  171.  
  172. Prefix_From_User  Prefix_To_Dial  Cost
  173.  
  174. The cost field may be omitted, and will be taken as 0 if blank.  
  175. The  prefix_to_dial may also be omitted as of  Version  0.91,  if it is 
  176. then the corresponding prefix supplied by the user will be stripped out 
  177. before dialing.
  178.  
  179.  
  180. S-VER.DOC                                                       PAGE 3
  181.  
  182.  
  183.  
  184.  
  185.  
  186.   For example,  if I  wanted to be  able to  call other systems  in the 
  187. Orlando 380 exchange no matter whether the user entered an area code or 
  188. not, I would put the  following lines into my PHONE#.CTL:
  189.  
  190. 407-380 380
  191. 380     380
  192.  
  193.    Phone  numbers  will be dealt with  based on the first match in the
  194. PHONE#.CTL file.  Therefore if you had a sequence like:
  195.  
  196. 407     1-407
  197. 407-380 407
  198.  
  199.   Then 407-380 would be dialed as 1-407-380 which is probably not what
  200. you wanted.  If a number is not found, it is treated as long distance.
  201. Otherwise  you can  control  whether each  number is  long distance or
  202. local by using the cost field.     This scheme should provide you with
  203. enough  flexibility  so that you can make the program do what you need
  204. no matter where in the world you are ;-)
  205.  
  206.  
  207.  
  208.  
  209. CONVERT.EXE
  210. -----------
  211.  
  212.   This little program will help you convert the  LOCAL.CTL  file used
  213. with other  Callback  verifiers  to the  PHONE#.CTL  needed by S-VER.
  214. LOCAL.CTL  Varies slightly  in the first few lines depending on which
  215. program  it was set for.    And all of  these lines  must be  deleted
  216. before using  CONVERT.    You must specify the local area code on the
  217. command line.  IE:
  218.  
  219. CONVERT 407
  220.  
  221.  
  222.  
  223. SVER-CFG.EXE
  224. ------------
  225.  
  226.   After  installing the new files,  you MUST run  SVER-CFG to upgrade 
  227. your config file to the new version.  
  228.  
  229.  
  230. SUPPORT FILES
  231. -------------
  232.   You completely  control the look of S-VER by placing these files in
  233. your text files directory (each may have .ANS and .ASC flavors).  You
  234. may create your own or edit and use the ones provided.
  235.  
  236.  
  237.  
  238.  
  239. S-VER.DOC                                                      PAGE 4
  240.  
  241.  
  242.  
  243.  
  244.  
  245. S-INTRO.A??
  246. -----------
  247.   The first  file the  user sees.    After this file is displayed,  a
  248. prompt is made to get phone number selection / confirmation.  S-Intro
  249. .A?? can be a short intro into the S-VER system to explain uses.
  250.  
  251.  
  252.  
  253. S-TRASH.A??
  254. -----------
  255.   This file is displayed if the phone number the user has selected is
  256. found in the  PHONENUM.CTL file.    This would indicate that you have
  257. blocked the number out for some reason.
  258.  
  259.  
  260.  
  261. S-DUPE.A??
  262. ----------
  263.   This file is displayed if another user has the same phone number as 
  264. the  one currently  chosen by the user,  and you have  selected  dupe 
  265. checking in the S-ver config.    A good idea here is to tell users to 
  266. Leave a message to the Sysop if they are requesting access and inform 
  267. them of Duplicate Phone Number.
  268.  
  269.  
  270. S-DISC.A??
  271. ----------
  272.   This file is  displayed  after the prompt,   and before hanging up.
  273. The purpose of  S-DISC.A??  is to inform the user that they are about
  274. to be disconnected.    Good idea  here is to  remind the users how to
  275. make their modem answer for them. 
  276.  
  277.  
  278. S-LOGIN.A??
  279. -----------
  280.   This is file that is displayed after the user answers the callback.
  281. S-LOGIN.A??  should be edited to customize the look and style of your
  282. board.
  283.  
  284.  
  285.  
  286. S-VALID.A??
  287. -----------
  288.   This file  is displayed  after the user properly  enters his or her
  289. password.    S-VALID.A??  is a welcome back to the system after comp-
  290. leting the Callback verifier.   A lot of Sysops tend to create custom
  291. screen here.
  292.  
  293.  
  294.  
  295.  
  296. S-VER.DOC                                                      PAGE 5
  297.  
  298.  
  299.  
  300.  
  301. S-LONGD.A??
  302. -----------
  303.   This file is displayed if the user is  long distance,  and you have
  304. configured no long distance calls or it's the wrong time of day for a
  305. Long distance callback.   If you have  configured  for  long distance
  306. during limited hours, you will want to indicate in this file the time
  307. period  when the user  should  call back  and try again.    Please be
  308. specific as to the Hours the user can call,  IE:     10pm to 3am East
  309. Standard Time.  Do not assume that everyone is on your time zone when
  310. allowing long distance call backs.
  311.  
  312.  
  313.  
  314. S-VERM.ASC
  315. ----------
  316.   This file  contains the  Users Manual for on-line help to the user. 
  317. The S-VERM.ASC is called in from the S-VERM.MNU, as a list ascii file 
  318. option.
  319.  
  320.  
  321.  
  322. S-VERM.MNU
  323. ----------
  324.   This is a sample menu ready to run..  just edit the necessary areas
  325. and colors  to  customize for your system.    The return to Main menu
  326. calls an  option 3,  but to be safe you can use an option 2  and give
  327. the menu name.
  328.  
  329.  
  330.  
  331. OPERATION OF S-VER PROGRAM
  332. --------------------------
  333.   'S-VER' may be run either as a  type 15 or a type 7 on a RA system.
  334. On a QuickBBS vs 2.66 , but not for Quickbbs 2.75 system,  it must be
  335. run as a type 15.  On multi-node systems, if there is no CONFIG.RA in
  336. the current directory,  you must specify the comm port number to use.
  337. This is easily done by using the  *P  parameter on a  type 7 command.
  338. If CONFIG.RA is in the current directory,  'S-VER' will take the comm
  339. port  from there and ignore anything on the  command line.    Command
  340. line parameters  are completely ignored on a QuickBBS system as it is
  341. always possible to get the comm port from CONFIG.BBS.
  342.                                                                      
  343.  
  344.  
  345. WARRANTY
  346. --------
  347.   If you break it,  and tell  me as much as you can about the circum-
  348. stances,  I will do my level best to make it work.  No other warranty
  349. is offered or implied.   You assume all responsibility for any damage
  350. to your equipment or data as a result of using this product.    I may
  351. feel bad about it,  but I'm  Not responsible  or liable.   Use of the
  352. product constitutes acceptance of this agreement.
  353.  
  354.  
  355.  
  356.  
  357. S-VER.DOC                                                      PAGE 6
  358.  
  359.  
  360.  
  361.  
  362.  
  363. PROGRESS REPORT / UPDATES:
  364. --------------------------
  365.  
  366. 7/2/90 
  367. Version 0.90
  368.   Initial Release for S-VER090.ZIP. This was the First release of the
  369. Beta Copy of S-VER. 
  370.  
  371.  
  372. 8/20/90
  373. Version 0.91
  374.   Fixed problem where file is not displayed fully before hanging up.
  375.   Fixed long distance calling hours bug.
  376.   Added capability for sysop to abort call during dial process.
  377.   Changed delay after modem initialization.
  378.   Fossil advertisement no longer trashes the screen.
  379.   Added support for higher X settings, let me know if this works right.
  380.   Added errorlevel exit depending on results of validation:
  381.     1:  Validation successful
  382.     2:  Validation failure 
  383.     3:  Validation not attempted
  384.     4:  Sysop error
  385.     5:  Program error
  386.   Added registration key system.
  387.  
  388.  
  389. 9/17/90
  390. Version 0.92
  391.   QuickBBS support added!!!
  392.   Fixed problem where user was allowed back on BBS, even if S-VER 
  393.     configuration said not to!
  394.   S-VER now waits for a carriage return from the user before displaying 
  395.   S-LOGIN.A??, this should fix the problem where S-LOGIN was not always
  396.     displayed after connect.
  397.   Minor bug in phone dupe checker fixed.
  398.  
  399.  
  400.  
  401. SPECIAL MENTIONS
  402. ----------------
  403.   A thank you  goes out to:  Peter Kling, The Computer Group, Ltd (tm) 
  404. 1:267/169.   For all of his work with this  Fine  Documentation,   and
  405. Alpha Bashing... Printed copies of 'S-VER' Documentation  and  Current
  406. copies of the Files are available through Peter Kling...  
  407.  
  408.  
  409.  
  410. COPYRIGHTS NOTICES
  411. ------------------
  412. S-VER (tm) is Copyrighted by STEVE GABRILOWITZ.
  413. QUICKBBS (tm) is Copyrighted by STEVE GABRILOWITZ & RICHARD CREIGHTON.
  414. REMOTE ACCESS (tm) is Copyrighted by CONTINENTAL SOFTWARE, LTD.
  415.  
  416.  
  417.  
  418. S-VER.DOC                                                      PAGE 7
  419.  
  420.